# Get group settings

Retrieve specific group settings by their keys. Returns a JSON object mapping setting names to their configured values. Only settings that the authenticated user has permission to read will be included in the response. Requires authentication and group membership.

Endpoint: GET /api/v1/groups/{groupId}/settings
Version: 1.0
Security: header

## Query parameters:

  - `keys` (array, required)
    Comma-separated list of setting keys to retrieve. Each key must correspond to a valid group setting definition registered in the system.

Available keys are:

group.ai.agents.budgets

group.join.questions

group.membership

group.moderation

group.privacy
    Example: "group.ai.agents.budgets,group.join.questions"

## Path parameters:

  - `groupId` (string, required)
    The unique identifier of the group
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

## Response 200 fields (application/json):

  - `group.ai.agents.budgets` (object)
    Budget limits in USD cents for AI agent executions.

  - `group.ai.agents.budgets.dailyBudgetCents` (integer)
    Daily budget in USD cents (null = unlimited)
    Example: "1000"

  - `group.ai.agents.budgets.monthlyBudgetCents` (integer)
    Monthly budget in USD cents (null = unlimited)
    Example: "10000"

  - `group.join.questions` (object)

  - `group.join.questions.show` (boolean)

  - `group.membership` (object)

  - `group.membership.allowMemberInvites` (boolean)

  - `group.membership.approveInvites` (boolean)

  - `group.membership.maxMembers` (integer)

  - `group.moderation` (object)

  - `group.moderation.blockedWords` (array)

  - `group.moderation.dailyPostLimit` (integer)

  - `group.moderation.moderateLinks` (boolean)

  - `group.moderation.moderatePosts` (boolean)

  - `group.moderation.slowModeEnabled` (boolean)

  - `group.moderation.slowModeInterval` (integer)

  - `group.moderation.spamFilter` (boolean)

  - `group.privacy` (object)

  - `group.privacy.showMemberList` (boolean)

  - `group.privacy.showStats` (boolean)

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation